Obiekt Cecha Części, lub formalnie Part::Feature
, jest prostym elementem kształtu topologicznego, który może być wyświetlany w oknie widoku 3D.
Cecha części jest klasą nadrzędną dla większości obiektów 2D (Rysunek roboczy, Szkicownik) i 3D (Część, Projekt części), z wyjątkiem siatek, które są zwykle oparte na cechach siatek, lub obiektach FemMesh dla obiektów MES.
Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.
Obiekt cecha części jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego, tylko z poziomu konsoli Python jak opisano w sekcji tworzenie skryptów.
Klasa Part::Feature
jest zdefiniowana w środowisku Część ale może być użyta jako klasa bazowa dla obiektów tworzonych skryptami we wszystkich środowiskach pracy które produkują kształty geometryczne 2D i 3D. Zasadniczo wszystkie obiekty produkowane w środowisku pracy Część są instancjami Part::Feature
.
Part::Feature
jest również klasą nadrzędną zawartości Projektu części, cechy Projektu części, oraz Part2DObject, która jest wyspecjalizowana dla kształtów 2D (planarnych).
Środowisko pracy może dodać więcej właściwości do tego podstawowego elementu, aby stworzyć obiekt o złożonym wyglądzie.
Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
Cecha części (klasa Part::Feature
) wywodzi się z podstawowej App: GeoFeature (klasa App::GeoFeature
), i dziedziczy wszystkie jego właściwości. Posiada również kilka dodatkowych właściwości. W szczególności właściwość DANEKształt, która przechowuje kształt topologiczny obiektu. Jest to geometria, która jest wyświetlana w oknie widoku 3D. Inne właściwości tego obiektu to te związane z wyglądem jego kształtu topologicznego.
Są to właściwości dostępne w edytorze właściwości|. Ukryte właściwości można pokazać za pomocą polecenia Wyświetl wszystko w menu kontekstowym okna edycji właściwości.
Podstawa
PythonObject
): klasa własna związana z tym obiektem. Występuje to tylko w wersji Python. Zobacz rozdział tworzenie skryptów.PartShape
): klasa Część: Kształt topologiczny związana z tym obiektem.Placement
): pozycja obiektu w oknie widoku 3D. Umieszczenie jest określone przez punkt Base
(wektor) i Rotation
(oś i kąt). Zobacz stronę Umiejscowienie.
0°
(zero stopni).0
a 1
. Jeśli jakakolwiek wartość jest powyżej 1
, wektor jest normalizowany tak, aby jego wielkość wynosiła 1
. Domyślnie jest to dodatnia oś Z, (0, 0, 1)
.(0, 0, 0)
.String
): nazwa obiektu edytowalna przez użytkownika, jest to dowolny ciąg znaków w kodowaniu UTF8.String
): dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny ciąg znaków UTF8, który może zawierać znaki nowej linii. Domyślnie jest to pusty łańcuch ""
.ExpressionEngine
): lista wyrażeń. Domyślnie jest ona pusta []
.Bool
): określa, czy obiekt ma być wyświetlany, czy nie.
Większość obiektów we FreeCAD ma coś, co nazywa się „dostawca widoku”, jest to klasa definiująca wygląd obiektu w oknie widoku 3D oraz w drzewie widoku. Domyślny dostawca widoku obiektów elementu części definiuje właściwości prezentowane poniżej. Obiekty skryptowe, które pochodzą z elementu cecha części, również będą miały dostęp do tych właściwości.
Podstawowe
PythonObject
): klasa własna dostawca widoku związana z tym obiektem. Istnieje wyłącznie dla wersji środowiska Python. Zobacz sekcję tworzenie skryptów.Opcje wyświetlania
Bool
): jeśli wartość to PRAWDA
, obiekt wyświetli ramkę ograniczającą w widoku 3D.Enumeration
): Linie główne
(regularna wizualizacja), Zacieniony
(bez krawędzi), Model krawędziowy
(bez ścian), Punkty
(tylko wierzchołki).Bool
): wartość domyślna to PRAWDA
, w którym to przypadku obiekt pojawi się w widoku widoku drzewa. W przeciwnym razie obiekt zostanie ukryty w widoku drzewa. Gdy obiekt w drzewie jest niewidoczny, można go ponownie wyświetlić, otwierając menu kontekstowe nad nazwą dokumentu (prawy przycisk myszy) i wybrać PRAWDA
.Bool
): jeśli ma wartość true
, obiekt pojawia się w widoku 3D. W przeciwnym razie jest niewidoczny. Standardowo właściwość ta może być przełączana przez naciśnięcie klawisza Spacja na klawiaturze.Wygląd obiektu
Angle
): jest to towarzysz WIDOKOdchylenia. Jest to kolejny sposób na określenie, jak precyzyjnie wygenerować siatkę do renderowania na ekranie lub podczas eksportu. Domyślną wartością jest 28.5 stopni
, lub 0.5 radiana
. Jest to wartość maksymalna, im mniejsza wartość tym gładszy będzie wygląd w widoku 3D, i tym drobniejsza będzie siatka, która zostanie wyeksportowana.FloatConstraint
): jest to towarzysz WIDOKOdchylenia kątowego. Jest to kolejny sposób na określenie, jak drobna ma być generowana siatka do renderowania na ekranie lub podczas eksportu. Domyślną wartością jest 0.5%
. Jest to wartość maksymalna, im mniejsza wartość tym gładszy będzie wygląd w widoku 3D i tym drobniejsza będzie siatka, która zostanie wyeksportowana.ColorList
): jest to lista krotek RGB definiujących kolory, podobna do WIDOKKolor kształtu. Domyślnie jest to lista zawierająca jeden ciąg [(0,8, 0,8, 0,8)]
.Enumeration
): Ciągła
(domyślnie), Kreskowana
, Kropkowana
, Kreska kropka
; definiuje styl krawędzi w widoku oknie widoku 3D.Enumeration
): Dwustronne
(domyślnie), Jednostronne
, oświetlenie pada z dwóch stron lub z jednej strony w oknie widoku 3D.Color
): krotka trzech zmiennoprzecinkowych wartości RGB (r,g,b)
do określenia koloru krawędzi w oknie widoku 3D. Domyślnie jest to (0.09, 0.09, 0.09)
, który jest wyświetlany jako [25,25,25]
o podstawie 255, almost black .ColorList
): jest to lista krotek RGB określających kolory, podobnie jak w przypadku WIDOKKolor linii. Domyślnie jest to lista składająca się z jednej wartości [(0.09, 0.09, 0.09)]
.Material
): Materiał powiązany z krawędziami w tym obiekcie. Domyślnie wartość ta jest pusta.FloatConstraint
): wartość typu zmiennoprzecinkowego, która określa szerokość krawędzi w pikselach w oknie widoku 3D. Domyślnie przyjmuje wartość 2.0
.Color
): podobnie jak WIDOKKolor linii, definiuje kolor wierzchołków.ColorList
): jest to lista krotek RGB określających kolory, podobna do WIDOKKolor wierzchołka. Domyślnie jest to lista [(0.09, 0.09, 0.09)]
.Material
): Materiał powiązany z wierzchołkami w tym obiekcie. Domyślnie wartość jest pusta.FloatConstraint
): podobnie jak WIDOKSzerokość linii, definiuje rozmiar wierzchołków.Color
): podobnie jak WIDOKKolor linii, określa kolor powierzchni. Domyślnie jest to (0.8, 0.8, 0.8)
, co jest wyświetlane jako [204, 204, 204]
na podstawie 255, a zatem jasny szary.Material
): Materiał związany z tym obiektem. Domyślnie wartość jest pusta.Percent
): liczba całkowita z zakresu 0
do 100
. (wartość procentowa) określająca poziom przezroczystości ścian w widoku 3D. Wartość 100
oznacza całkowicie niewidoczne ściany Ściany są niewidoczne, ale nadal można je wybierać tak długo, jak wartość WIDOKDo wyboru wynosi PRAWDA
.Wybieranie
Enumeration
): kontroluje sposób, w jaki zaznaczenie pojawia się w oknie widoku 3D, jeśli obiekt ma kształt i jest wiele obiektów częściowo zakrytych przez inne. Domyślna wartość to Wyłaczone
, co oznacza, że nie pojawi się żadne specjalne podświetlenie. Wartość Włączone
oznacza, że obiekt pojawi się na wierzchu każdego innego obiektu, gdy zostanie wybrany, Object
oznacza, że obiekt pojawi się na wierzchu tylko jeśli cały obiekt jest zaznaczony w widoku drzewa. Wartość Element
oznacza, że obiekt pojawi się na wierzchu tylko jeśli element podrzędny (wierzchołek, krawędź, ściana) jest zaznaczony w widoku 3D.Bool
): jeśli parametr ma wartość PRAWDA
, obiekt może być wybrany kursorem myszki w widoku 3D. W przeciwnym razie, obiekt nie może być wybrany dopóki ta opcja nie zostanie ustawiona na PRAWDA
.Enumeration
): kontroluje sposób podświetlania obiektu. Jeśli wybrano Kształt
, cały kształt (wierzchołki, krawędzie i ściany) będzie podświetlony w widoku 3D; jeśli jest to Ramka otaczająca
, pole ograniczające pojawi się wokół obiektu i zostanie podświetlone.
Ugięcie kątowe i parametry odchylenia; d < odchylenie liniowe, α < ugięcie kątowe.
Odchylenie jest wartością w procentach, która jest związana z wymiarami w milimetrach ramki otaczającej obiekt. Odchylenie w milimetrach można obliczyć w następujący sposób:
deviation_in_mm = (w + h + d)/3 * deviation/100
gdzie w
, h
, d
są wymiarami ramki otaczającej.
Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.
Cecha części jest tworzona za pomocą metody dokumentu addObject()
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Feature", "Name")
obj.Label = "Custom label"
Dlatego też, dla klasy podrzędnej Python, powinieneś stworzyć obiekt Part::FeaturePython
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::FeaturePython", "Name")
obj.Label = "Custom label"
Zobacz również: Nazwa obiektu, aby uzyskać więcej informacji na temat właściwości Nazwy
.
Metoda addObject
posiada dwa podstawowe argumenty typu string.
"Part::FeaturePython"
.Name
. Jeśli nie zostanie podany, domyślnie przyjmuje taką samą nazwę jak klasa, czyli "Part__FeaturePython"
. Nazwa Name
może zawierać tylko proste znaki alfanumeryczne oraz podkreślnik, [_0-9a-zA-Z]
. Jeśli podane zostaną inne symbole, zostaną one zamienione na znaki podkreślenia, na przykład "A+B:C*"
jest zamieniane na "A_B_C_"
.
W razie potrzeby atrybut Etykieta
może zostać zmieniony na bardziej wymowny tekst.
Etykieta
może przyjąć dowolny ciąg znaków UTF8, włączając w to akcenty i spacje. Ponieważ widok drzewa wyświetla Etykietę
, dobrą praktyką jest zmiana atrybutu Etykiety
na bardziej opisowy ciąg znaków.Etykieta
jest unikalna, tak jak Nazwa
. Jednak to zachowanie może być zmienione w Edytorze Preferencji, Edycja → Preferencje → Ogólne → Dokument → Zezwalaj na duplikowanie etykiet obiektów w jednym dokumencie. Oznacza to, że ogólnie Etykieta
może być powtarzana w tym samym dokumencie, podczas testowania dla konkretnego elementu użytkownik powinien polegać na Nazwie
, a nie na Etykiecie
.